home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / misc / euphoric.zip / readme < prev   
Text File  |  1995-03-19  |  5KB  |  97 lines
  1. Euphoric is an Oric1/Atmos emulator. This version is not a definitive one,
  2. but it is good enough to be widely distributed and it will surely make Oric
  3. enthusiasts feel a lot of nostalgia, and I hope it will be a favorable factor
  4. for them to meet again.
  5.  
  6. The up-to-date version will always be on a web server, URL :
  7. http://www.ensica.fr/LOCAL/ORIC/euphoric.html
  8. There you will also find the latest information, tools and programs for the
  9. Oric.
  10.  
  11. Euphoric runs on PCs only for now, but you can chose between DOS and Linux.
  12. The DOS version is expected to be soon fully DPMI compatible and runnable
  13. under the DOS boxes of Windows 3.1, OS/2, and Windows NT 3.5.
  14. A multi-platform Unix version is also in stage, thanks to O.Balet's help.
  15.  
  16. Before asking any question, you must be aware that you need an Oric rom image
  17. to run euphoric. So, you must be a real Oric user to use euphoric; you can
  18. read your oric rom with an eprom programmer, use a tape transfer utility, a
  19. parallel link utility, or delegate me this task through the web server if you
  20. don't want to open your box or risk the life of your Oric.
  21.  
  22. Questions and Answers
  23.  
  24. Q1: How to contact me and get some help, or just tell me a program works or
  25. does not work...
  26. Q2: It doesn't work : I get "svgalib: Cannot get I/O permissions"
  27. Q3: It doesn't work : I get "Not running in graphics-capable virtual console"
  28. Q4: It doesn't work : I get "Oric.ROM not found"
  29. Q5: I used readtape to get my ROM : it is more than 16384 bytes...
  30. Q6: CLOAD doesn't work...
  31. Q7: I've got multi-part programs or protected programs...
  32. Q8: My protected program doesn't load, help!
  33. Q9: My program loads but then the emulator crashes...
  34. Q10: How to quit Euphoric ?
  35.  
  36. R1: Send me a mail at frances@ensica.fr
  37.  
  38. R2: Euphoric needs the right to access VGA physical IO ports. It uses some
  39. routines of the svgalib library. As every other application using svgalib,
  40. the program must be 'setuid root'. Become root, verify that root owns the
  41. program and set the setuid bit ("chmod u+s euphoric") then quit super-user
  42. mode, you should start the emulator.
  43.  
  44. R3: Euphoric uses svgalib. This library allows to develop graphical applications
  45. while not using X-Window. It doesn't work under X11 (it doesn't have to), you
  46. must start the emulator under a virtual console.
  47.  
  48. R4: Euphoric reads a ROM from the file Oric.ROM (Unix users, take note of the
  49. case) in the current directory. You can use an Oric 1 rom, an Atmos rom, or
  50. every rom you write. If an Oric 1 or Atmos rom is detected (address of the reset
  51. vector), it will be patched accordingly to allow tape commands.
  52.  
  53. R5: You need to get rid of the file header. If you saved the ROM on tape without
  54. a name (ie. CSAVE "",A#C000,E#FFFF), it should be 16398 bytes. Just use the
  55. unix command :
  56. dd if=oric.old of=Oric.ROM bs=1 skip=14
  57. If you are a DOS user, load the file with debug, then :
  58. -R CX
  59. 4000
  60. -W10E
  61. -Q
  62.  
  63. R6: The name you specify in a CLOAD command is taken without modification under
  64. the host operating system. With Unix, lowercase et uppercase is meaningfull,
  65. so if you ask for CLOAD "MYPROG", uppercase name MYPROG has to be a file name
  66. in current directory. You can use a path with CLOAD, eg. CLOAD"FILES/MYPROG"
  67. with Unix or CLOAD"D:\FILES\MYPROG" with Dos, but be careful since the Oric
  68. cuts the file name and keeps only 16 character.
  69.  
  70. R7: readtape reads only the first file found in the wave file. When recording,
  71. sample each program in a different file, or cut the file with your graphical
  72. utility (find the pauses). Rename the files with the original name found by
  73. readtape, if needed. If it doesn't work, it might be that a multi-part program
  74. don't use names since the tape is sequential. If you cannot hack into the
  75. program to introduce names, use the following : concatenate the parts in a file
  76. named "Tape" (note the uppercase under unix). Under the emulator, just use
  77. CLOAD"" (the "Tape" file will be used for the first loading omitting the file
  78. name, and for every next loading, without "rewinding" the file). Just use cat
  79. under Unix to catenate files. With Dos, use the command :
  80. COPY FILE1+FILE2+...+FILEN /B TAPE
  81.  
  82. R8: The format chosen for programs should accomodate the most used protections
  83. (change of the header during loading, different synchro characters, etc). The
  84. "Tape" file will evolve in next versions to a bit file very close to the
  85. contents of the tape, without a strong penalty in file size (13 bits for 8).
  86. If it is not enough, I will introduce another format keeping track of the
  87. length of bits.
  88.  
  89. R9: There is still missing code in this emulator, I need to complete my VIA
  90. emulation, eg. the two timers keep running at 100 Hz. I need to emulate
  91. undocumented opcodes, too, some programs may use them. Send me your program
  92. so I could diagnose the problem. If a program works, tell me too, I will
  93. maintain a list of good/partial/bad compatibility.
  94.  
  95. R10: Key F10 exits the emulator cleanly. I currently have a problem under Linux
  96. with key Ctrl-C since svgalib gets it before me, and exits the emulator.
  97.